Geometric Operations Applicable to Bitmap Shapes (IM: XG)

Inside Macintosh: QuickDraw GX Graphics /: Chapter 5 - Bitmap Shapes / Applying Functions Described Elsewhere to Bitmap Shapes

Geometric Operations Applicable to Bitmap Shapes
Most geometric operations post errors or warnings when applied to bitmap shapes, as described in "Functions That Post Errors or Warnings When Applied to Bitmap Shapes" on page 5-55.
You can, however, apply the remainder of the functions described in Chapter 4, "Geometric Operations," to bitmap shapes. Table 5-4 gives important bitmap-related information for a subset of these functions. The remainder of the geometric operations exhibit the same behavior when applied to bitmap shapes as they do when applied to other types of shapes.
Geometric operations that exhibit special behavior when applied to bitmaps
Function name Action taken
GXGetShapeArea Returns bitmap width multiplied by bitmap height.
GXPrimitiveShape Applies sourceGridStyle attribute to bitmap position.
GXSimplifyShape Reduces the pixel size of the bitmap if the bitmap uses a limited number of colors.
GXSetShapeBounds If the gxMapTransformShape shape attribute is set, this function changes the transform mapping of the bitmap; otherwise, it changes the bitmap height, width, and location, and creates a new, scaled version of the bit image to fit in the new bounding rectangle.

Geometric operations that exhibit special behavior when applied to bitmaps
Function name	Action taken
GXGetShapeArea	Returns bitmap width multiplied by bitmap height.
GXPrimitiveShape	Applies `sourceGridStyle` attribute to bitmap position.
GXSimplifyShape	Reduces the pixel size of the bitmap if the bitmap uses a limited number of colors.
GXSetShapeBounds	If the `gxMapTransformShape` shape attribute is set, this function changes the transform mapping of the bitmap; otherwise, it changes the bitmap height, width, and location, and creates a new, scaled version of the bit image to fit in the new bounding rectangle.